Skip to content

docs: let the structure lead and recenter the landing page on the runtime + standard#56

Merged
kasperjunge merged 1 commit into
mainfrom
docs/loop-engineering-five-jobs
Jun 8, 2026
Merged

docs: let the structure lead and recenter the landing page on the runtime + standard#56
kasperjunge merged 1 commit into
mainfrom
docs/loop-engineering-five-jobs

Conversation

@kasperjunge

Copy link
Copy Markdown
Collaborator

What

Follow-up to #55. Removes the explicit "five jobs" jargon, cuts noise from the docs, and gives the landing page a makeover centered on Ralphify as the runtime for loop engineering that runs the open ralph loops standard.

Docs

  • Drop the "five jobs" framing across index.md, cli.md, 404.md, and README.md. Write → feed → run → steer → share stays as the underlying structure, just no longer named as a concept nobody recognizes yet (headings, numbered cards, and cross-links all updated).
  • Remove the noisy info/callout boxes (!!!/??? admonitions) in Getting Started and the CLI reference. High-signal bits (args, the frontmatter-restart gotcha, troubleshooting checklist) folded into prose; pure noise cut.
  • Getting Started cleanups: removed the Prerequisites section and the "verify it's working" step; uv-only install (dropped pip/pipx); added a directory file tree so it's clear a ralph is a directory, not a single file; pulled args into its own worked subsection.

Landing page

  • Recentered the message: hero is now "Write the loop once. Ralphify runs it." framing Ralphify as the runtime and the ralph loops standard as the open format. New section under the hero spells out the standard-vs-runtime split.
  • Removed cookbook everywhere (nav, hero, CTA, footer).
  • Fixed broken links & wrong commands: ralph initralph scaffold; dead docs/agents/docs/cli/#using-different-agents; removed dead docs/blog/ links; dropped the pip/pipx install note.

Checks

  • ruff check . passes
  • mkdocs build --strict passes

🤖 Generated with Claude Code

Drop the explicit 'five jobs' framing across docs, README, and the landing
page — keep write/feed/run/steer/share as the underlying structure without
naming it as a concept nobody recognizes yet. Remove the noisy info/callout
boxes, fold the high-signal bits into prose, and cut the prerequisites and
pip/pipx alternatives in favor of uv. Add a directory file tree and a clear
args subsection in Getting Started. Recenter the landing page on Ralphify as
the runtime for loop engineering that runs the open ralph loops standard, and
remove dead cookbook/blog/agents links and the wrong 'ralph init' command.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
ralphify-co c32e264 Commit Preview URL

Branch Preview URL
Jun 08 2026, 06:27 PM

@kasperjunge kasperjunge merged commit 59fa192 into main Jun 8, 2026
6 checks passed
@kasperjunge kasperjunge deleted the docs/loop-engineering-five-jobs branch June 8, 2026 18:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant